home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 January / Macworld (1998-01).dmg / Shareware World / Utilities / Video / control-freak-1.1 / Control Freak • Read Me < prev    next >
Text File  |  1997-10-07  |  7KB  |  136 lines
  1.  
  2. "Control Freak"   Written by Lance Drake -  Version 1.1
  3.                   Copyright 1997 -  All rights reserved  
  4.                      Comments/Suggestions: lance@drake.org
  5. -----------------------------------------------------------
  6.  
  7. Q: What is 'Control Freak'?
  8. This PPC application allows the User to make adjustments to the 
  9. display settings of an Apple Video input system.  They are then saved
  10. so that they may be quickly called up at a later time.  
  11.  
  12. Q: Why would you need an app like 'Control Freak'?
  13. A: The "Apple Video Player" application does not have a 'Hue' control 
  14. (as of this writing) and this was the initial reason for creating it. 
  15. Additionally, other video related applications little or no
  16. adjustment of the video input signal.  In some apps, there is not 
  17. offered control over the full range of some parameters.  Also, the
  18. selector for whether the video input is from a realtime video source
  19. such as the video output of a tuner versus the playback of a video
  20. tape from a VCR is not always supported in all apps.  If this is 
  21. not set properly, the image can be considered completely unviewable.  
  22.  
  23.  
  24. Hardware Support Limitations:
  25. -----------------------------------------------------------
  26.  
  27. This app only works with Apple Macintosh PowerPC models:   
  28.           
  29.            7500, 7600, 8500, and 8600
  30.  
  31. Q: Why not all Macs with video input capability? 
  32. A: Because the hardware is different in these other computers and must 
  33. be accessed differently and a number of salient details are not known 
  34. that would make this possible.  Perhaps in a future version.  
  35.  
  36. ---------------------------------------------------------------------
  37.  
  38. Q: What about the controls, buttons and sliders?
  39.  
  40. CONTROLS:
  41.  
  42. ‘Sliders’:  
  43. By pointing and clicking on the 'slider' controls and then moving the 
  44. 'thumb' left or right, it is possible to send a message to the hardware 
  45. which will cause the image as captured by the hardware and delivered to 
  46. the current video display window to be changed in one way or another.  
  47. Simply clicking on the 'line' of a slider will cause the 'thumb' to chase 
  48. to that point.  The middle position of each slider control is the 
  49. approximate middle of the control range and will be most likely to allow 
  50. for a viewable image is all controls are set there.  As it happens, the 
  51. image on the system on which this app was developed had a video input 
  52. system which tended to make everyone's face look like an overripe lemon.  
  53.  
  54. ‘Update Hardware’:  
  55. Pressing this button sends the current slider settings and the ‘Input 
  56. is VCR playback’ checkbox settings to the hardware.  It is useful  in 
  57. that it is not necessary to ‘touch’ each control to make the settings 
  58. active.  It is also useful to update the hardware which may have been 
  59. adjusted as a result of another application being launched.   
  60.  
  61. ‘Use Defaults’:
  62. Pressing this button causes the default values stored as a resource in the 
  63. application to be fetched, loaded into the controls and sent to the hardware.   
  64. These values may be changed as desired by using ‘ResEdit’ or ‘Resorcerer’.  
  65. The values to which these resources may be set are included in the title of 
  66. each member of the resource.  There is a ‘TMPL’ resource included in the app 
  67. which makes this a pretty simple process once you get the app opend for 
  68. resource editing.  
  69.  
  70. ‘Input is VCR Playback’:
  71. This checkbox changes the time constant of the horizontal sync detector 
  72. such that it is more tolerant of the jitter which is generated by video 
  73. tape machines during playback of a tape.  
  74.  
  75. --------------------------------------------------------------------------------
  76.  
  77. Other notes:  
  78. ‘Control Freak’ remembers its window position when closed.  If you get into 
  79. a situation where the window is not accessable (which should never happen, 
  80. but can) you simply throw away the preferences file ('Control Freaks.prefs') 
  81. in the Preferences folder located in the active system folder of the ‘Boot’
  82. disk.  When next the application is launched, the default values for window 
  83. location and control settings will be loaded in from a resource in the 
  84. application and applied to the various settings.  The current settings are 
  85. saved automatically when the app is Quit.
  86.  
  87. Changing the defaults:
  88. Using 'ResEdit' or 'Resorcerer' will allow the experienced User to change 
  89. the settings which are imposed as the initial defaults or when the 'Use 
  90. Defaults' button is pressed.  The simplest way to accomplish an adjustment 
  91. here is to launch the program, get everything looking just as you would wish 
  92. and then Quit the app.  To be safe, save off a copy of the app AND the preferences 
  93. file.  Then open the app and the 'Control Freak.prefs' file using the resource 
  94. editor of choice, copy the 'pref' resource (ID = 1000) from the prefs file and 
  95. replace it into the app file.  Save and close both files then relaunch.  Hitting 
  96. the 'Use Defaults' button will show whether you have accomplished this correctly.  
  97. If not,then make a copy of your back up disks and adjust accordingly.
  98.  
  99. 'Control Freak'is 'Apple Scriptable':
  100. To the extent that you can begin recording an Apple Script, launch an app such 
  101. as 'Apple Video Player', then launch the 'Control Freak' app, use the 'File' 
  102. menu of the app to cause it to be 'Quit' and then 'Stop Recording' the Apple 
  103. Script.  Later, you can replay the Apple Script to cause the 'Apple Video Player' 
  104. to be launched and have the image adjusted as you would like in that 'Control 
  105. Freak' will issue commands to the video hardware based on the contents of it's 
  106. preferences file. 
  107.  
  108. Below is an example of an Apple Script you might want to modify and use:
  109. ------------------------------------------------------------------------
  110. tell application "Finder"
  111.     activate
  112.     select file "Apple Video Player " of folder "Apple Menu Items" of folder "System 8" of startup disk
  113.     open selection
  114.     select file "Control Freak" of folder "Projects" of startup disk
  115.     open selection
  116. end tell
  117. tell application "Control Freak"
  118.     activate
  119.     quit
  120. end tell
  121. tell application "Finder"
  122.     activate
  123. end tell
  124.  
  125. --------------------------------------------------------------------------------
  126.  
  127. Q: Is 'Control Freak' shareware or what?
  128. A: 'Control Freak Version 1.1' is FREEWARE so long as it is not modified in any
  129. way functionally or in appearance and so long as the author's name is not removed
  130. from it in any way or from any resources.  'Control Freak' may not be resold but
  131. may be distributed freely to others.
  132.  
  133. ---------------------------------------------------------------------------------
  134. eof: 'Control Freak • Read Me'
  135.  
  136.